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About This Manual 


Read This First 


This manual describes the TMS320C3x peripheral control library—a 
collection of data structures and macros for controlling the ’'C3x bus control 
peripherals, DMA, serial ports, and timers via the C programming language. 


How to Use This Manual 


This document contains the following chapters: 


Chapter 1: 
Chapter 2: 


Chapter 3: 


Appendix A: 


Appendix B: 


Style and Symbol Conventions 


Overview. Describes the features of the library files. 


TMS320C3x Peripheral Set. Describes the header files, 
macros, and pointers for the ’C3x peripherals. 


TMS320C3x Peripheral Control Example. \llustrates how 
the ’C3x Peripheral Control Library can be used to program 
a ’C3x serial port. 


Tables of Peripheral Registers, Structure-Member 
Names, and Bit-Field Names. Provides examples and 
tables listing the names used to access each of the peripheral 
registers and bit fields through C-peripheral pointers. 


Header Files. Includes bus30.h, dma30.h, serprt30.h, and 
timer30.h header file listings. 


This document uses the following conventions. 


_] Program listings, program examples, interactive displays, filenames, and 
symbol names are shown in a special typeface similar to a 
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Style and Symbol Conventions 


typewriter’s. Examples use abold version of the special typeface for 
emphasis; interactive displays use a bold version of the special 
typeface to distinguish commands that you enter from items that the 
system displays (such as prompts, command output, error messages, 
etc.). 


Here is a sample program listing: 


0011 0005 0001 -field eee 
0012 0005 0003 .field 3, 4 
0013 0005 0006 .field 6, 3 
0014 0006 .even 


Here is an example of a system prompt and a command that you might 
enter: 


C: esr -a /user/ti/simuboard/utilities 


In syntax descriptions, the instruction, command, or directive is in a bold 
typeface font and parameters are in an italic typeface. Portions of a syntax 
that are in bold should be entered as shown; portions of a syntax that are 
in italics describe the type of information that should be entered. Here is 
an example of a directive syntax: 


sasect section name”, address 


.asect is the directive. This directive has two parameters, indicated by 
section name and address. When you use .asect, the first parameter must 
be an actual section name, enclosed in double quotes; the second 
parameter must be an address. 


Square brackets ([ and ] ) identify an optional parameter. If you use an 
optional parameter, you specify the information within the brackets; you 
don’t enter the brackets themselves. Here’s an example of an instruction 
that has an optional parameter: 


LALK 16-bit constant [, shift] 


The LALK instruction has two parameters. The first parameter, 16-bit 
constant, is required. The second parameter, shift, is optional. As this 
syntax shows, if you use the optional second parameter, you must 
precede it with a comma. 


Square brackets are also used as part of the pathname specification for 
VMS pathnames; in this case, the brackets are actually part of the 
pathname (they are not optional). 


Braces( {and} ) indicate alist. The symbol | (read as or) separates items 
within the list. Here’s an example of a list: 


{ * | *+ | *- } 


Related Documentation From Texas Instruments 


This provides three choices: *, *+, or *-. 


Unless the list is enclosed in square brackets, you must choose one item 
from the list. 


(_} Some directives can have a varying number of parameters. For example, 
the .byte directive can have up to 100 parameters. The syntax for this 
directive is: 


-byte value, [, ..., value, ] 


This syntax shows that .byte must have at least one value parameter, but 
you have the option of supplying additional value parameters, separated 
by commas. 


Related Documentation From Texas Instruments 


TMS320 Floating-Point DSP Assembly Language Tools User’s Guide 
(literature number SPRUO35) describes the assembly language tools 
(assembler, linker, and other tools used to develop assembly language 
code), assembler directives, macros, common object file format, and 
symbolic debugging directives for the ’C3x and ’C4x generations of 
devices. 


TMS320 Floating-Point DSP Optimizing C Compiler User’s Guide 
(literature number SPRU024) describes the TMS320 floating-point C 
compiler. This C compiler accepts ANSI standard C source code and 
produces TMS320 assembly language source code for the ’C3x and 
’C4x generations of devices. 


TMS320C3x User’s Guide (literature number SPRU031) describes the ’'C3x 
32-bit floating-point microprocessor, developed for digital signal 
processing as well as general applications. Covered are its architecture, 
internal register structure, instruction set, pipeline, specifications, and 
operation of its DMA and its two serial ports. Software and hardware 
applications are included. 


TMS320C40 Parallel Runtime Support Library User’s Guide (literature 
number SPRU084) describes the ’C40 Parallel Runtime Support Library, 
a standard method of programming the ’C40 peripherals at the register 
and bit level via the C programming language. Library and header files, 
asummary of parallel runtime support functions and macros, a functions 
reference, and a listing of header files are included. 
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If You Need Assistance 


If You Need Assistance. . . 


vi 


If you want to... 


Request more information about 
Texas Instruments Digital Signal 
Processing (DSP) products 


Order Texas Instruments 
documentation 


Ask questions about product 
operation or report suspected 
problems 


Report mistakes in this document 
or any other Tl documentation 


Do this. .. 


Call the CRCT: 
(214) 995-6611 


Or write to: 

Texas Instruments Incorporated 

Market Communications Manager, MS 736 
P.O. Box 1443 

Houston, Texas 77251-1443 


Call the CRCT: 
(214) 995-6611 


Call the DSP hotline: 
(713) 274-2320 


Fill out and return the reader response card at 
the end of this book, or send your comments to: 
Texas Instruments Incorporated 

Technical Publications Manager, MS 702 

P.O. Box 1443 

Houston, Texas 77251-1443 


Tt Texas Instruments Customer Response Center 
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Chapter 1 


Overview 


This user’s guide describes the TMS320C3x Peripheral Control Library, a 
standard for controlling ’C3x peripherals using the C programming language. 
The library, part of the TMS320 Floating-Point DSP Optimizing C Compiler, of- 
fers consistency in naming and accessing variables, thereby reducing devel- 
opment time for new code and facilitating code maintenance. 


Because all the ‘C3x peripherals and their corresponding registers are 
memory-mapped, a device’s peripheral can be controlled easily from C code. 
The flexibility of the C language allows structures to be defined for modifying 
’°C3x peripheral memory-mapped registers. Furthermore, because many of 
the peripheral control registers use individual bit locations to define functional- 
ity, bit fields are implemented in this standard with C bit-field structures. 


By utilizing this standard for controlling ’C3x peripherals, you can develop cus- 
tom support libraries that are both portable and readable. 


This document describes the TMS320C3x peripheral registers and their struc- 
ture member names and gives examples on how to utilize the library. 
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TMS320C3x Peripheral Set 


The TMS320C3x peripherals include external buses, direct memory access 
(DMA), two serial ports, and two timers. The on-chip integration of all of these 
peripherals increases processor performance and overall system hardware 
integration. Each application has different peripheral requirements and config- 
urations that must be programmed before you use the peripheral. The periph- 
erals are configured by writing values to the corresponding control register. For 
example, the following nondescriptive C statement starts timer 0 by writing a 
value of 0x2C1 into the timer 0 global control register at address 0x808020: 


*(unsigned int *)0x808020 = 0x2Cl1; 


The ’C3x Peripheral Control Library simplifies writing more readable C code 
and helps make the DSP code consistent from one application to the next. 


This chapter discusses these topics: 


Topic Page 
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Header Files 


2.1 Header Files 


2-2 


The ’C3x Peripheral Control Library consists of four header files: 
[_.} bus30.h 

__} dma30.h 

[__] serprt30.h 


[_] timer30.h 


The header files declare structures and macros. In particular, each header file 
declares: 


(_] Data structures for the peripheral’s memory mapping 
|_| Data structures for the bit fields of the peripheral’s control registers 


[_.} Macros for declaring pointers to the peripherals 


_} Macros for bit field assignment 


Before using a peripheral macro or data structure, you must include the ap- 
propriate header file in the program, as shown below. 


#include <timer30.h> 


TIMER_ADDR (0) —>gcontrol=0x0; 


Macros 


2.2 Macros 
Four macros facilitate the assignment of C pointers to the four peripherals: 
_j BUS_ADDR 
J DMA_ADDR 
[J SERIAL_PORT_ADDR(n) 


Cy} TIMER_ADDR(n) 


These macros assign C symbols to the peripheral base addresses and type- 
cast the memory location to point to the peripheral data structure. For exam- 
ple, BUS_ADDR is defined as follows: 


) 


#define BUS_ADDR ((volatile BUS_REG *) ((char *) BUS_BASE 


where BUS_REG is the data structure describing the bus control register 
memory mapping (discussed in the next section) and BUS_BASE is 0x808060. 
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Pointers 


2.3 Pointers 
Pointers to peripherals are then used to access the peripheral control regis- 
ters. Peripheral pointers point to data structures that represent the mapping 
of the peripheral control registers. The four data structures are: 

|_| BUS_REG 

_J DMA_REG 


__J SERIAL_PORT_REG 


_J TIMER_REG 


For example, the *C3x memory map of the timer control registers described in 
Figure 2-1 is defined in C with the TIMER_REG data structure that follows the 
figure: 


Figure 2-1. Memory-Mapped Timer Locations 


Register Peripheral Address 


Timer 0 Timer 1 
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typedef 


{ 


} TIM 


TIM 


struct 


ER_R 


EG; 


ER_CONTROL 
unsigned 
unsigned 
unsigned 
unsigned 


int 
int 
int 
int 


Pointers 


Jot ri; /* Timer global control */ 
reserved1[3]; /* 3 reserved locations */ 
counter; /* Timer counter */ 
reserved2[3] /* 3 more reserved locations */ 
period; /* Time period */ 


Because the peripheral control registers can change independently of the 
CPU, peripheral pointers should be declared by using the volatile-data type 
qualifier. Example 2-1 shows howto use the TIMER_REG data structure 
and the TIMER_ADDR(n) macro to assign *timerO_ptr to point to timer 0. 


Example 2-1. Declaring a Peripheral Pointer 


volatile TIMER_REG *timer0O_ptr = TIMER_ADDR(0); 


The peripheral control registers can be set one bit at a time or by assigning an 
integer value to the register. Example 2—2 shows how to use both integer and 
bit-field methods for halting timer 0 by setting the HLD bit of the timer global 
control register to zero. This example uses the timer pointer from 
Example 2-1. To aid in these operations, descriptive macros for both bit-field 
and integer manipulations are defined in the header files. 


Example 2-2. Two Methods of Setting Control Registers 


Integer Method: timerO_ptr—>gcontrol &= ~0x80 
Bit-Field Assignment Method: timerO_ptr—>gcontrol_bit.hld_ = 0 
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Chapter 3 


TMS320C3x Peripheral Control Example 


This chapter illustrates how you can use the ’C3x Peripheral Control Library 
to program the ’C3x serial port 0 via several combined methods of setting up 
the control registers. 


Consider the following configuration of serial port 0: 


[__] Generate the bit clock at 8M bits per second (assuming a 32-MHz input 


clock) 
[_] Generate frame sync pulses 
[_] Transmit/receive 32-bit data 
[_] Operate in standard/fixed mode 
[_.] Generate interrupts on data transmitted 
To obtain this configuration, you must set the serial port registers accordingly: 
Register Address Value 
Global Control 0x808040 0xCBC00C4 
FSX/DX/CLKX Port Control 0x808042 Ox111 
FSR/DR/CLKR Port Control 0x808043 Ox111 
Rec/Trans Timer Control 0x808044 Ox3CF 


Example 3-1 illustrates how this configuration is achieved with the ‘C3x Pe- 
ripheral Control Library. The control segment is highly readable and produces 
efficient assembly code when compiled. 
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TMS320C3x Peripheral Control Example 


Example 3-1. Configuring a TMS320C3x Serial Port 


#include <serprt30.h> 


/* define a pointer to serial port 0 */ 
volatile SERIAL_PORT_REG *sp0 = SERIAL _PORT_ADDR(0) ; 


/* set serial port 0’s fsr/dr/clkr port control register by integer assignment */ 
SERIAL_PORT_ADDR(0)->s_r_control = 0x111; 


/* set serial port 0’s_ fsx/dx/clkx port control register by integer 
assignment using descriptive macros*/ 
sp0->s_x_control = CLKXFUNC | DXFUNC | FSXFUNC; 


/* set serial port 0’s global control register by bit field assignment*/ 
SERIAL_PORT_ADDR(0)->global_bit.fsxout = 1; 

sp0->global_bit.xclksrce = 1; 

sp0->global_bit.rclksrce = 1; 

sp0->global_bit.xlen = XLEN_32; 

sp0->global_bit.rlen = RLEN_32; 


tdectcoteaoe ¢ 


sp0->global_bit.xint = 1; 
sp0->global_bit.xreset = 1; 
sp0->global_bit.rreset = 1; 


/* set serial port 0’s rec/transm timer control register */ 
sp0->s_rxt_control = xGO | HLD_ | xcP_ 
XCLKSRC | RGO | RHLD_ | RCP_ | RCLKSRC; 
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Appendix A 


Tables of Peripheral Registers, 


Structure-Member Names, and Bit-Field Names 


The TMS320C3x Peripheral Control Library provides C data structures for 
manipulating the TMS320C3x peripherals. The following tables list the data 
structure member names used to access each of the peripheral registers and 
bit fields through C peripheral pointers. Refer to the TMS320C3x User's Guide 
for a detailed explanation of the registers and bit-field descriptions. The first 
entry for each register shows how to access that register as an integer. The 
remaining entries show how to access the register’s bit fields individually. Each 
table is followed by an example. 


This appendix includes these tables: 


Topic Page 
Table-A=1 Bus Control! .......00:ccic0e cevevee teva seee vat sesews ewes fa-2] 
Table:A=2 DMA Controllastastss ens esa saeee ecammaceee ee nem a-2] 
Table A-3 Serial Port Control .............0:0e cece e eee eee eee eee A-3| 
TablerA—4" Timer Control ae -: ce emg cee me aie ee cia eneree 
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Tables of Peripheral Registers, Structure- Member Names, and Bit-Field Names 


Table A-1. Bus-Control Registers 


[eaeResieter [Assignment [BitFietd —[WemberName 


pe ire — Faso 


Example A—1. Bus Control 


#include<bus30.h> 
volatile BUS_REG *bus_ptr=BUS_ADDR; /* define pointer to bus peripheral */ 
bus_ptr->exp_gcontrol=0; /* zero wait states on expansion bus */ 


Table A—2. DMA-Control Registers 


[eaeRegiatr [Assignment BR ——‘[WamberName 


INCSRC —>gcontrol_bit.incsrc 
START —>gcontrol_bit.start 


[DNA DesinatonAasress_[itegorassanment [= peaesinaln 
[DWATeansfer Counter [regerassanment [== -starsfer counter 


Example A—2. DMA-Control Registers 


#include <dma30.h> 
volatile DMA_REG *dma=DMA_ADDR; /* define pointer to dma */ 
dma->gcontrol_bit.start=STOP; /* stop the dma by setting the start bits*/ 


STAT —>gcontrol_bit.stat 
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Tables of Peripheral Registers, Structure-Member Names, and Bit-Field Names 


Table A-3. Serial-Port-Control Registers 


[oaeRegisier [Assignment [SRF [WomberNane | 
Bit-field assignment 
[Dae [Sonesta 
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Tables of Peripheral Registers, Structure-Member Names, and Bit-Field Names 


Table A—3. Serial-Port-Control Registers (Continued) 


[oaeResisier [Assignment [ened [WemberName 
DRE [FeoconroL bs 


FSRDATOUT 
FSRFUNC 


FSX/DX/CLKX Port Control Integer assignment 


Bit-field assignment 


Tables of Peripheral Registers, Structure-Member Names, and Bit-Field Names 


Tables of Peripheral Registers, Structure- Member Names, and Bit-Field Names 


Table A—3. Serial-Port-Control Registers (Concluded) 


[eae Reiter [signet [Faas 
Receive/Transmit Timer Control Integer assignment |— = [>s_xtcontrol 
Receive/Transmit Timer Counter Integer assignment |— = [-s_rxt_counter 
Receive/Transmit Timer Period Integer assignment |— = [-ssixt_period 

ie ecco 
a 


Example A-3. Serial Port Control 


#include <serprt30.h> 
volatile SERIAL_PORT_REG *sp1=SERIAL_PORT_ADDR(1); /* define pointer to serial port 1 */ 
spl-> x_data= uncompress (x); /* write out result */ 
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Tables of Peripheral Registers, Structure- Member Names, and Bit-Field Names 


Table A-4. Timer-Control Registers 


[oaeResisier [Assignment [BFie_—[WomberName 


a ee as 
= 


Example A—4. Timer Control 


#include<timer30.h> 
volatile TIMER_ADDR(0)->gcontrol=0; /* stop timer */ 

/* determine remaining time */ 
int time_remain=TIMER_ADDR (0) ->period-TIMER_ADDR (0) -—>counter 
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Appendix B 


Header Files 


This appendix lists the bus30.h, dma30.h, serprt30.h, and timer30.h header 
files: 


Topic Page 
Bl) ibusa0-h)Header Elle ctiyiccncetesegesee tesa vdeeeatad eves taasl B-2| 
B.2sdmase hitleador Pile x. asaegne ves ttenees aac ranacnenh sees B-5] 
Bd. -serprisd: Wiltsader hlgs2 sen can-ect-eaee etree einen aur ccnnee B-7 
Ba’ lmers0ch Header Files... cca aves na cease can cwaneses cee nantes B-14| 
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bus30.h Header File 


B.1 bus30.h Header File 


[KK KK KK HK KK IK I I I A I A A A A A I A A A A A A A A A A I A A I I He / 


/* bus30.h v4.5 
/* Copyright (c) 


[KK KK KK HK HK IK KK I I I A A A I A I A A A A A A A IA A A A A A A a I 


#ifndef 
#define 


#define 
#define 
#define 
#define 


_BUS30 
_BUS30 


exp_gcontrol 


exp_gcontrol_bit 
prim_gcontrol 


A 


1991 Texas Instruments Incorporated a 


_egctrl._intval 


_egctrl._bitval 
_pgctrl._intval 


prim_gcontrol_bit _pgctrl._bitval 


[KK KR KK KK I I I I I A A A A I A OR / 


/* MACRO DEFINITION FOR BUS BASE ADDRESS xy 
[FOCI IO ICICI IO ICICI III ICI III ICI IO III IC IO III ICI IO I ICI ICE IO III IA IO A I A ICA IO a7 


#define 
#define 


BUS_BASE 
BUS_ADDR 


0x808060 


((volatile BUS_REG *) ((char *) BUS_BASE) ) 


[KK KK HK HK HK KK I KI I I I I A I A A A A A I A A A A A A A A A A a I a / 


/* STRUCTURE DEFINITION FOR PRIM AND EXP BUS GLOBAL CONTROL REGISTERS */ 
[FOR IO IO ICICI ICICI I IC IO II IOI II I IC IO II IC IO IIR IR IO IIR I IO II A I A a / 


typedef 
{ 


union 


unsigned int _intval; 
Struct 


{ 


unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 


} _bitval; 
} PRIMARY _BUS_CONTROL; 


typedef 
{ 


union 


in 
in 
in 
in 
in 
in 
in 


holdst 
nohold 
hiz 
sww 
wtcnt 
bnkcmp 
fr_rest 


CF EF CEE OEY £9 oer .€F 


unsigned int _intval; 
struct 


{ 


unsigned 
unsigned 
unsigned 
unsigned 


} _bitval; 
} EXPANSION_BUS_CONTROL; 
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imt ©r_0L2 
int sww 
int wtcnt 
int r_rest 


1; /* Hold status bit */ 
1; /* Port hold signal */ 
21; /* Internal hold */ 
£25 /* S/W wait mode */ 
3; /* S/W wait count */ 
5; /* Bank compare */ 
19; /* reserved */ 
23; /* reserved */ 
22; /* S/W wait mode */ 
23; /* S/W wait count */ 
24; /* reserved */ 


Header Files 


bus30.h Header File 


[BRK KK KK KK KK AK KK A A AAA AA AA A A A AA AA A A A A I I I / 


/* STRUCTURE DEFINITION FOR BUS REGISTERS */ 
[FORO RIC IO ICI IO ICICI II IO III IC IO IOI IO II IC IO II I IO I I I IO IO A I ak / 


typedef struct 
{ 


EXPANSION_BUS_CONTROL _egctrl; /* Exapansion bus control register */ 

unsigned int reservedl1 [3]; /* reserved */ 

PRIMARY_BUS_CONTROL _pgctrl; /* Primary bus control register */ 
} BUS_REG; 


[RRR KR KK KR KK OK KK KK KK KK KR KR OK RR RR OR OK KK OK OK OK OK KK OK KK / 


/* BUS MACROS FOR BIT FIELD DEFINITIONS */ 
[ORO CIC IO IC IC IO ICI ICI I ICICI IO ICI IC III IC IO III ICI IO III ICA IO II I IC IO AOI I IER Ok / 


/* Bus macros for global control registers integer assignments * / 
/* e.g. BUS_ADDR->prim_gcontrol = EXTERNAL_RDY | WS_1; sets the */ 
/* corresponding bits of the primary bus control register. aif 


[8 RK KK KK KK KK IK A A A A A A AA A A AA A A A A A A A A A I I I / 


#define HOLDST Ox1 
#define NOHOLD Ox2 
#define HIZ Ox4 
#define EXTERNAL _RDY 0x00 
#define INTERNAL RDY 0x08 
#define OR_EXT_INT 0x10 
#define AND_EXT_INT 0x18 
#define WS_O 0x00 
#define WS_1 0x20 
#define WS_2 0x40 
#define WS_3 0x60 
#define WS_4 0x80 
#define WS_5 OxA0 
#define WS_6 0xCO 
#define WS_7 OxEO 
#define BANK_16M 0x00 
#define BANK_8M 0x100 
#define BANK_4M 0x200 
#define BANK_2M 0x300 
#define BANK_1M 0x400 
#define BANK_512K 0x500 
#define BANK_256K 0x600 
#define BANK_128K 0x700 
#define BANK_64K 0x800 
#define BANK_32K 0x900 
#define BANK_16K 0xA00 
#define BANK_8K 0xBOO 
#define BANK_4K 0xC00 
#define BANK_2K OxDOO 
#define BANK_1K OxE00 
#define BANK_512 OxF0OO 
#define BANK_256 0x1000 


bus30.h Header File 


[KK KK HK HK KK IK I I I A I I I A A A A A A A A A A A A A A A A I a I He a / 


/* Bus macros for global control registers bit field assignments ay 
/* e.g. BUS_ADDR->prim_gcontrol_bit.sww = AND_RDY; */ 
/* BUS_ADDR->exp_gcontrol_bit.wtcnt = WAIT_2; */ 
/* sets the appropriate bits of bus control registers. ws 


[OK KK KK HK HK KK I I I A I A A A A A A I A A A A A A A A A I a I  / 


#define HOLD 1 
#define INT_RDY 
#define EXT_RDY 
#define OR_RDY 
#define AND_RDY 
define BANK_SIZ 
define BANK_SIZ 
#define BANK_SIZ 
#define BANK _SIZ 
define BANK_SIZE_ 

define BANK_SIZE_512K 
define BANK_SIZE_256K 
#define BANK _SIZE_128K 


HO Gl BF 


13 | 

a 

ik 
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define BANK_SIZE_64K 

define BANK_SIZE_32K 

define BANK_SIZE_16K 10 
#define BANK_SIZE_8K 11 
#define BANK_SIZE_4K 12 
define BANK_SIZE_2K 13 
define BANK_SIZE_1K 14 
#define BANK_SIZE_512 15 
#define BANK_SIZE_256 16 


define WAIT_O 0 
define WAIT_1 1 
#define WAIT_2 2 
#define WAIT_3 3 
#define WAIT_4 4 
5 
6 
7 


#define WAIT_5 
#define WAIT_6 
#define WAIT_7 


#endif /* #ifndef _BUS30 */ 
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dma30.h Header Files 


B.2 dma30.h Header Files 


[BORK KK KK KK KK KK A A A A A AA A A A AA A A A AAA A A A A I I I / 


x7] 


/* dma30.h v4.5 
/* Copyright (c) 1991 Texas Instruments Incorporated 


[BRK KK KK KK KK KK A A A A A A A A A AA A A AAA AA A A A A A A I I / 


#ifndef _DMA30 
#define _DMA30 


#ifndef gcontrol 
#define gcontrol _gctrl._intval 
#endif 


#ifndef gcontrol_bit 
#define gcontrol_bit _gctrl._bitval 


#endif 

[BRK KK KK KK KK RA A A A A AAA AAA AAA AR A A A A A A A I I I / 
/* MACRO DEFINITIONS FOR DMA BASE ADDRESS */ 
[ROKK RK KK KR KR KK KK KK OK RK KK OR KK OR KO KR OK OK OK OK OK RK OK RK OK KK KK / 
#define DMA_BASE 0x808000 

#define DMA _SIZE 16 

#define DMA_ADDR ((volatile DMA_REG *) ((char *) DMA _BASE) ) 


[RRR RR KK KR KK OK OK KK OK KK OK KK RK RK OK RK KK KK OK OK KK OK KK / 


/* STRUCTURE DEFINITION FOR DMA GLOBAL CONTROL REGISTER */ 
[FOO CIC IO ICICI IO ICICI II IC IO ICI IC IO III IC IO III ICI I III ICA IO II I IR I A I I IR FO / 


typedef union 
{ 


unsigned int _intval; 


struct 

{ 
unsigned int start 22> /* Start/Stop control */ 
unsigned int stat Hea /* DMA status */ 
unsigned int incsre ss /* Increment source addr ON/OFF */ 
unsigned int decsre ae /* Decrement source addr ON/OFF */ 
unsigned int incdst 315 /* Increment dest addr ON/OFF */ 
unsigned int decdst shies /* Increment dest addr ON/OFF */ 
unsigned int sync 225 /* Source/dest synchronization */ 
unsigned int tc 1s /* Transfer terminate control */ 
unsigned int tcint sds /* DMA interrupt to CPU control */ 
unsigned int r_rest 220; /* reserved */ 


} _bitval; 
} DMA_CONTROL; 
[RRR KK KK KR KK KK KK KK KK KK KK KR RO KR KK OK OK KK KK OK KK / 


/* STRUCTURE DEFINITION FOR DMA REGISTERS */ 
[ORCI IO ICICI ICICI III ICI IO III IG IO III IC IO III ICA I III ICA IO II I I I I I I Ia Ok / 


typedef struct 
{ 


DMA_CONTROL _gcetrl; /* Global control register */ 
unsigned int reservedl [3]; /* reserved */ 
unsigned int source; /* Source address register */ 
unsigned int reserved2[1]; /* reserved */ 
unsigned int destination; /* Destination address register */ 
unsigned int reserved3[1]; /* reserved */ 
unsigned int transfer _counter; /* Transfer counter register */ 
} DMA_REG; 
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dma30.h Header Files 


[OK KK HK HK HK I OK I I I I A A A A A IA A A A A A A A IA I A A A A I I He / 


/* DMA MACROS FOR BIT FIELD DEFINITIONS a 
[3 OR IOI III III IO III IO III IC IO II IC IO III ICR IO IIR IR IO II A IC AO a / 


/* DMA macros for global control register integer assignments */ 
/* e.g. DMA_ADDR->gcontrol = STARTO | SYNC1 TCINT sets the corresponding*/ 
/* bits of the DMA global control register */ 
[RK KK KK KK I I A I A A A A A A I a ok / 
#define STARTO 0x0 

#define STARTL Ox1 

#define START2 0x2 

#define START3 0x3 

define STATO 0x0 

define STATI Ox4 

#define STAT2 0x8 

#define STAT3 OxC 

define INCSRC 0x10 

define DECSRC 0x20 

define INCDST 0x40 

#define DECDS 0x80 

define SYNCO 0x00 

define SYNC1 0x100 

define SYNC2 0x200 

#define SYNC3 0x300 

#define TC 0x400 

define TCINT 0x800 

[KK KK KK HK HK KK I I I I I A A A A A A A A A A IA A A A I A A A A I I I He a / 
/* DMA macros for global control register bit field assignments */ 
/* e.g. DMA_ADDR->gcontrol.incsrc = INCREMENT; */ 
/* e.g. DMA_ADDR->gcontrol.incdst = INCREMENT; */ 
/* sets the appropriate bits of the DMA global control register */ 


[KK KK KK IK I I I A A I A A I A I I / 


#define INCREMENT 1 
#define DECREMENT 1 
#define TERMINATE 1 


#endif /* #ifndef _DMA30 */ 
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serprt30.h Header Files 


B.3 serprt30.h Header Files 


[BRK KR KK KR KK KR OK KK KK KK KR KR RK OR RR KK OR OR KR OK OK OK OK OK OK KK OK / 


af 


/* serprt30.h v4.5 

/* Copyright (c) 1991 Texas Instruments Incorporated 

[KR KK RK KK KK KK RK A A A A A A A AA A AA AAA A AA AA A A A A I I / 
#ifndef _SERPRT30 

#define _SERPRT30 

#ifndef gcontrol 

#define gcontrol _gctrl._intval 

#endif 

#ifndef gcontrol_bit 

#define gcontrol_bit gcetri., _batval 

#endif 

#define s_x_control _xctrl._intval 

#define s_x_control_bit xctrl._bitval 

#define s_r_control _rctrl._intval 

#define s_r_control_bit retrl._bitval 

#define s_rxt_control _rxtctrl._intval 

#define s_rxt_control_bit _rxtctrl._bitval 

#define s_rxt_counter _rxtcounter._intval 

#define s_rxt_counter_bit _rxtcounter._bitval 

#define s_rxt_period _rxtperiod._intval 

#define s_rxt_period_bit rxtperiod._bitval 

[RRR KR KK KR KK KK KK OK KK KK RK OK OK RR OR OR OR KOK OK OK OK OK KK KK KK / 
/* MACRO DEFINITIONS FOR SERIAL PORT BASE ADDRESS */ 
[KR KK RK KK KK KK KK A RA A A A AA AAA A A AAA ROA A A OA I I I / 
#define SERIAL PORT_ZERO 0 

#define SERIAL _PORT_ONE 1 

#define SERIAL PORT_BASE 0x808040 

#define SERIAL _PORT_SIZE 16 

#define SERIAL PORT_ADDR(n) ((volatile SERIAL _PORT_REG *) ((char *) \ 


SERIAL _PORT_BASE + (n) *SERIAL_PORT_SIZE) ) 
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[OK KK HK HK IK KK I I I A A A I A I A A A A A A A A IA A IA I A A I He / 


/* STRUCTURE DEFINTION FOR SERIAL PORT GLOBAL CONTROL REGISTER */ 
3 IORI ICICI ICICI I IC IO II IO IO III IC IO III IC IO III I IO IIR IR IO I I A I IO a / 


typedef union 
{ 


unsigned int _intval; 


struct 

{ 
unsigned int rrdy le /* Receive ready flag */ 
unsigned int xrdy Saale /* Transmitt ready flag */ 
unsigned int fsxout ele /* FSX configuration */ 
unsigned int xsrempty :1; /* Transm shift reg empty */ 
unsigned int rsrfull :1; /* Receive registers full */ 
unsigned int hs uly /* Handshaking mode enable */ 
unsigned int xclksrce :1; /* Transm clock source */ 
unsigned int rclksrce :1; /* Receive clock source */ 
unsigned int xvaren sles /* Transm data rate signaling */ 
unsigned int rvaren lee /* Receiv data rate signaling */ 
unsigned int xfsm z1; /* Transm frame sync mode */ 
unsigned int rfsm sls /* Receiv frame sync mode */ 
unsigned int clkxp ply /* Transm clock polarity */ 
unsigned int clkrp Le /* Receiv clock polarity */ 
unsigned int dxp PL; /* Transm data polarity */ 
unsigned int drp cals /* Receiv data priority */ 
unsigned int fsxp sly /* Transm frame sync polarity */ 
unsigned int fsrp ope /* Receiv frame sync polarity */ 
unsigned int xlen <2 /* Transm data word length */ 
unsigned int rlen 2 /* Receiv data word length */ 
unsigned int xtint alee /* Transm timer interrupt enable */ 
unsigned int xint sy /* Transm interrupt enable */ 
unsigned int rtint lee /* Receiv timer interrupt enable */ 
unsigned int rint eal /* Receiv interrupt enable */ 
unsigned int xreset z1; /* Transm reset */ 
unsigned int rreset spl lees /* Receiv reset */ 
unsigned int r_rest 24; /* reserved */ 

} _bitval; 

} SERIAL_PORT_CONTROL; 
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[KR KK RK KK KK KK IK A A A RK A A A AA AAR A AA RA A A A A I I I I / 


/* STRUCTURE D 


/* REGISTER 


EFINTION FOR SERIAL PORT RECEIVE/TRANSMIT PORT CONTROL 


*/ 
*/ 


[RRR KR KK KR KK KR KR KK OK KR KK KK KK OK OK KK OR OK OK OK OK OK KK OK OK KK KK / 


typedef union 
{ 


unsigned int _intval; 


struct 


{ 


unsigned int clkfunc 
unsigned int clki_o 
unsigned int clkdato 
unsigned int clkdati 
unsigned int dfunc 
unsigned int di_o 
unsigned int ddatout 
unsigned int ddatin 
unsigned int fsfunc 
unsigned int fsi_o 
unsigned int fsdatout 
unsigned int fsdatin 
unsigned int r_rest 


} _bitval; 


Ne Ne Ne Ne Ne 


oN 


Ne Ne Ne Ne 


NPPRPPPPRPEPHP PPB 
~ 


ot 
~e 


} RX_PORT_CONTROL; 


/* Clock function control 
/* Clock i/o control 

/* Data output on clock 
/* Data input on clock 

/* Data function control 
/* Data i/o control 

/* Data output on data 


/* Data 


input on data 


/* Frame sync function control 


/* Frame syne i/o control 


/* Data input 


/* Data output on frame sync 


on frame sync 
/* veserved 


[BRK KK KK KK KK IR A A A A A A AAA A A A AA A A A RA A A A A I I I / 


/* STRUCTURE D 


EFINTION FOR SERIAL PORT RECEIV 


/* REGISTER 


E/TRANSMIT TIMI 


ER CONTROL 


Bah 
4 


[RRR RR KK KR KK OK OK KK KR KR OK KK OR KO OR OK OK OR OK OK OK OK OK OK KK OK OK KK / 


typedef union 
{ 


unsigned int _intval; 


struct 


{ 


unsigned int xgo 
unsigned int xhld_ 
unsigned int xcp_ 
unsigned int xclksrc 
unsigned int r_4 
unsigned int xtstat 
unsigned int rgo 
unsigned int rhld_ 
unsigned int rcp_ 
unsigned int rclksrc 
unsigned int r_10 
unsigned int rtstat 
unsigned int r_rest 


} _bitval; 


Ne Ne Ne Ne Ne 


oN 


Ne Ne Ne 


~ 


NPRPRPRPPRPEPRPRPRPER 
s 


ot 
~ 


} RX_TIMER_CONTROL; 


/* Reset and start transmit timer 


/* Transm timer hold 
/* Transm clock mode 
/* Transm clock source 


/* reserved 


/* Transmit timer stat 


/* Reset and start receive timer 


/* Receive timer hold 
/* Receive clock mode 
/* Receive clock source 


/* reserved 


/* Receive timer stat 


/* reserved 
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[ROCIO IO ICICI ICICI IO ICICI III ICI IO ICI IC IO III ICI IO I ICI ICI IO III ICA IO I I A ICA IO a / 
/* STRUCTURE DEFINTION FOR SERIAL PORT RECEIVE/TRANSMIT TIMER COUNTER e/ 


/* REGISTER 


7 


[8K KK IK KK I I I I A A A A A A A I a ek / 


typedef union 
{ 
unsigned int _intval; 
struct 
{ 
unsigned int x_counter:16; 
unsigned int r_counter:16; 
} _bitval; 
} RX_TIMER_COUNTER; 


/* Transmit timer counter */ 
/* Receive timer counter */ 


[ROR RIOR IO IC IO ICICI II IC IO III IO III IC IO II IC IO IOI IC IO IIR I IO II A IO I a / 
/* STRUCTURE DEFINTION FOR SERIAL PORT RECEIVE/TRANSMIT TIMER PERIOD +] 


/* REGISTER 


my, 


[KK KK KK HK IK IK KI I I I I IA A A A A I A A A I IA A I A A A A A A I a I He / 


typedef union 
{ 
unsigned int _intval; 
struct 
{ 
unsigned int x_period :16; 
unsigned int r_period :16; 
} _bitval; 
} RX_TIMER_PERIOD; 


/* Transmit timer period */ 
/* Receive timer period */ 


[KK KK KK HK HK I IK I I A A A A A A A A A A A A A A A A A A A A I a I HH / 


/* STRUCTURE DEFINITION FOR SERIAL PORT REGISTERS aah 
OCR IO IO ICICI ICICI ICI IO II IO IO III IC IO II IC IO III ICR IO IIR I IO IOI A IR a a / 


typedef struct 
{ 


SERIAL_PORT_CONTROL _gctrl; 
unsigned int reservedl; 
RX_PORT_CONTROL —_xectri; 
RX_PORT_CONTROL Jrotris 
RX_TIMER_CONTROL ExXtctrls 
RX_TIMER_COUNTER _rxtcounter; 
RX_TIMER_PERIOD _rxtperiod; 
unsigned int reserved2; 
unsigned int x_data; 
unsigned int reserved3 [3]; 
unsigned int r_data; 
unsigned int reserved4 [3]; 


} SERIAL _PORT_REG; 
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/* Serial port global control */ 
/* veserved */ 

/* Transm port control */ 

/* Receive port control */ 


/* Receive/transmit timer control */ 
/* Receive/transmit timer counter */ 


/* Receive/transmit timer period */ 
/* veserved */ 

/* Serial port transmit data */ 

/* veserved */ 

/* Serial port receive data */ 

/* reserved */ 


Header Files 


serprt30.h Header Files 


[BRK KK KK KK KK AK A A IA KA AA AA AAR RA A A A AA A I I I / 


/* SERIAL PORT MACROS FOR BIT FIELD DEFINITIONS */ 
[FOR IORI IO ICICI III II IO II II IO IOI IO II ICR IO II I IO I I I IO II A I ak / 


/* Serial port macros for global control register integer assignments A 
/* e.g. SERIAL_PORT_ADDR(0)->gcontrol = XVAREN | DxXP | XLEN_16 set the */ 
/* corresponding bits of serial port 0’s global control register */ 
[ROKK RK KK KR KR KK KR KK KR KR IK KK KR KR RR OK OK KK OR KK OK OK KK / 
#define RRDY Oxl 

#define XRDY Ox2 

#define FSXOUT Ox4 

#define XSREMPTY 0x8 

#define RSRFULL 0x10 

#define HS 0x20 

#define XCLKSRCE 0x40 

#define RCLKSRCE 0x80 

#define XVAREN 0x100 

#define RVAREN 0x200 

#define XFSM 0x400 

#define RFSM 0x800 

#define CLKXP 0x1000 

#define CLKRP 0x2000 

#define DXP 0x4000 

#define DRP 0x8000 

#define FSXP 0x10000 

#define FSRP 0x20000 

#define XLEN_8 0x00000 

#define XLEN_16 0x40000 

#define XLEN_24 0x80000 

#define XLEN_32 0xC0000 

#define RLEN_8 0x000000 

#define RLEN_16 0x100000 

#define RLEN_24 0x200000 

#define RLEN_32 0x300000 

#define XTINT 0x400000 

#define XINT 0x800000 

#define RTINT 0x1000000 

#define RINT 0x2000000 

#define XRESE 0x4000000 

#define RRESE 0x8000000 
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#define INPUT_PIN 
#define OUTPUT_PIN 
#define DISABLED 
#define ENABLED 
#define EXTERNAL 
#define INTERNAL 
#define FIXED 
#define VARIABLE 
#define CONTINUOUS 
#define STANDARD 
#define ACTIVE_HIGH 
#define ACTIVE_LOW 
#define EIGHT _BITS 
#define SIXTEEN_BITS 
#define TWENTY_FOUR_BITS 2 
#define THIRTY_TWO_BITS 3 
#define RESET 0 
#define UN_RESET 1 


POFRPROCOFRPFOFOFOFRO 


E 


[KOK KK KK KK IK I I I I A A A A A A I I I a  e/ 


/* Serial port macros for fsx/dx/clkx control register integer */. 
/* assignments, e.g. SERIAL _PORT_ADDR(0)->s_x_control = CLKXFUNC DXFUNC */ 
/* sets the corresponding bits of serial port 0’s fsx/dx/clkx control */ 
/* register a, 


[KK HK KK KK I I I I A I A I A A A I A A I / 


#define CLKXFUNC Ox1 
#define CLKXI_O Ox2 
define CLKXDATOUT 0x4 
define CLKXDATIN 0x8 
#define DXFUNC 0x10 
#define DXI_O 0x20 
define DXDATOUT 0x40 
define DXDATIN 0x80 
define FSXFUNC 0x100 
#define FSXI_O 0x200 
#define FSXDATOUT 0x400 
define FSXDATIN 0x800 


[OK KK HK HK HK IK OK I KI A I I A A IA I A IA A IA A A A A A A A A A a I a / 


/* Serial port macros for fsr/dr/clkr control register integer */ 
/* assignments, e.g. SERIAL_PORT_ADDR(0)->s_r_control = CLKRFUNC | DRFUNC */ 
/* sets the corresponding bits of serial port 0’s fsr/dr/clkr control */ 
/* register */ 


[KK KK KK KK I KI A A A A A a a  e/ 


define CLKRFUNC Ox1 
#define CLKRI_O Ox2 
#define CLKRDATOUT 0x4 
#define CLKRDATIN 0x8 
define DRFUNC 0x10 
define DRI_O 0x20 
#define DRDATOUT 0x40 
#define DRDATIN 0x80 
define FSRFUNC 0x100 
define FSRI_O 0x200 
#define FSRDATOUT 0x400 
#define FSRDATIN 0x800 
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#define GENERAL_PURPOSE_IO 0 
#define SERIAL_PORT_PIN 1 


[BRK KK KK KK IK KK A KA A A A A A A A AA AAA A A AA A A A A I I / 


/* Serial port macros for receive/transmit timer control register integer */ 


/* assignments, e.g. SERIAL_PORT_ADDR(0)->s_rxt_control = XGO RGO ee / 
/* sets the corresponding bits of serial port 0’s receive/transmit control*/ 
/* register */ 


[BORK KK KK KK KK KK A A AR A AA A A A A A A A A RR A A OR I I / 


#define XGO Ox1 


#define XHLD_ Ox2 
#define XCP_ Ox4 
#define XCLKSRC 0x8 
#define XTSTAT 0x20 
#define RGO 0x40 
#define RHLD_ 0x80 
#define RCP_ 0x100 
#define RCLKSRC 0x200 
#define RSTAT 0x800 


#endif /* #ifndef _SERPRT30 */ 
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B.4 timer30.h Header File 


[OK KK KK I I I I A A A A A I I  / 


/* timer30.h v4.5 ay: 
/* Copyright (c) 1991 Texas Instruments Incorporated oy, 
[1% KKK KK HK HK IK KI A A A A I A A A IA A A A A A A A A A A I A A a a I He / 
#ifndef _TIMER30 

#define _TIMER30 


#ifndef gcontrol 
#define gcontrol _gctrl._intval 
#fendif 


#ifndef gcontrol_bit 
#define gcontrol_bit _gctrl._bitval 
#fendif 


[KKK KK KK KK I I I IA I A I A A A A A A I A A A A IA A A I A a I a / 


/* MACRO DEFINITIONS FOR TIMER BASE ADDRESS */ 
[8K KK OK KK I KI I I I A I A A A A A I A I a  / 
define TIMER_ZERO 0 

define TIMER_ONE 1 

#define TIMER_BASE 0x808020 

#define TIMER_SIZE 16 

define TIMER_ADDR(n) ((volatile TIMER_REG *) ((char *) TIMER_BASE \ 

+ (n)*TIMER_SIZE) ) 


define TMR_HLD_O TIMER_ADDR(0)->gcontrol &= ~HLD_ 
define TMR_HLD_1 TIMER_ADDR(1)->gcontrol &= ~HLD_ 


[KK KK KK KK I I I I A A A A I I A I OR ek / 


/* STRUCTURE DEFINITION FOR TIMER GLOBAL CONTROL REGISTER */ 
[ROCIO IO ICICI ICICI ICI ICI III ICI IO III IC IO III IC IO III ICI IO III ICA IO I I A ICA AO a / 


typedef union 
{ 


unsigned int _intval; 


struct 

{ 
unsigned int func silts /* Timer pin function */ 
unsigned int i_o sc. /* Timer i/o control */ 
unsigned int datout 21; /* Data output on timer */ 
unsigned int datin oat ee /* Data input on timer */ 
unsigned int r_45 25 /* reserved */ 
unsigned int go pie /* Reset and start timer */ 
unsigned int hld_ ie /* Counter hold */ 
unsigned int cp_ rl; /* Clock/pulse mode control */ 
unsigned int clksrc z1; /* Clock source */ 
unsigned int inv su. /* Invert control */ 
unsigned int tstat 21; /* Timer status */ 
unsigned int r_rest 220; /* reserved */ 


} _bitval; 
} TIMER_CONTROL; 
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[BRK KK KK KK KK A KR A A A A A AAA A AAA RA A AA A A A I I / 


/* STRUCTURE DEFINITION FOR TIMER REGISTERS */ 
[FORO RIC IO ICICI II IO IO ICO III IO I IC IO III IO III IO II I I IO AO A I Ok / 


typedef struct 
{ 


TIMER_CONTROL _gctrl; /* Timer global control */ 
unsigned int reservedl [3]; /* reserved */ 
unsigned int counter; /* Timer counter */ 
unsigned int reserved2 [3]; /* reserved */ 
unsigned int period; /* Timer period */ 


} TIMER_REG; 
[BORK KK KK KK KK KK A A A A A A A A AAA A A A AA A A A A A I I I / 


/* TIMER MACROS FOR BIT FIELD DEFINITIONS xf 
[FORO RIC IO ICICI II IO II IO III IO II IOI IC IO II I IO IO I I IO I A I Ok / 


/* Timer macros for global control register integer assignments af 
/* e.g. TIMER_ADDR(0)->gcontrol = FUNC | GO | HLD_ | CLKSRC sets the */ 
/* corresponding bits of timer 0’s global control register */ 
[ROKK KR KK KR KK OK KK KK KR KR OK OK OK RK KR OR OR KR OK OK OK OR OK OK KK KK KK / 
#define FUNC Ox1 

#define I_O 0x2 

#define DATOUT 0x4 

#define DATIN 0x8 

#define GO 0x40 

#define HLD_ 0x80 

#define CP_ 0x100 

#define CLKSRC 0x200 

#define INV 0x400 

#define TSTAT 0x800 

[ROKK KR KK KR KK OK OK KK OK KK KK KK RK OR RK KK OK OK KK OK OK OK KK / 
/* Timer macros for global control register bit field assignments */ 
/* e.g. TIMER_ADDR(0)->gcontrol_bit.func = TIMER_PIN; */ 
/* TIMER_ADDR(0)->gcontrol_bit.go = SET; */ 
/* TIMER_ADDR(0)->gcontrol_bit.hld_ = SET; */ 
/* TIMER_ADDR(0)->gcontrol_bit.clksrc = INTERNAL; */ 
/* sets the appropriate bits of timer 0’s global control register. a 


[BORK KK KK KK KK IK KK A A A A A A A AA AAA A A A RA A A A I I I / 


#define TIMER_PIN 1 
#define INPUT 

#define OUTPUT 
#define CLOCK_MODE 
#define PULSE_MODE 
#define INVERT 
#define NON_INVERT 
#define EXTERNAL 
#define INTERNAL 


#endif /* #ifndef _' 


H FPOOrRFORFO 


IMER30 */ 
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